MFileSaver – A file save dialog window.

Creation: MFileSaver_New(caption$, path$, filter$, cancel, changeDir, x, y, pixelwidth, pixelheight)

caption$ - The text that is displayed caption title window.

path$ - Starting directory. Can be literal like “c:\game” or relative like “data\player\save”.

filter$ - File extension filter. empty=all; or any specific extension. “.avi”, “avi”, etc.

cancel – Allow cancel button feature. 0-cancel disabled; 1-cancel allowed.

changedir- Allow directory change. 0-none; 1-any inside starting directory; 2-full access drives/folders.

x – Pixel X coordinate for the top left corner of the file save dialog.

y – Pixel Y coordinate for the top left corner of the file save dialog.

pixelwidth – The width of the file save dialog in pixels.

pixelheight – The height of the file save dialog in pixels. Not including save-as/confirm dialogs.

Functions:

MFileSaver_Clear(index)

Clears file save dialog to defaults.

MFileSaver_Delete(index)

Deletes the file save dialog.

MFileSaver_Draw(index)

Draws the file save dialog to screen.

MFileSaver_GetFileName(index)

Returns string, filename currently selected. empty=no file; filename

MFileSaver_GetPath(index)

Returns string, full directory path currently selected. empty=impossible; directory path

MFileSaver_GetSelected(index)

Returns file save dialog pressed status. 0=file not picked; 1=file was picked; 2=cancel

MFileSaver_Refresh(index)

Updates the file save dialog directory and file contents.